home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / sound / players / unix / olvm / readme.snd < prev    next >
Encoding:
Text File  |  1993-02-10  |  5.1 KB  |  123 lines
  1. HAT DOES THIS DO?
  2. -----------------
  3. his patch adds sounds to events in olvwm and it adds an optional visual
  4. peedup to olvwm.
  5. vents are all the things that the window manager deals with.  They include
  6. hings like mapping and unmapping windows, mouse button events, key presses
  7. in the root window) and many others.
  8. he sounds can be (semi)dynamically bound to events and the sounds can be
  9. urned on and off with a menu option.
  10. he speedup consists of disabling the drawing of lines from the icon to the
  11. ull window when opening or closing a window.  This speedup is disabled by
  12. efault but can be enabled with a resource.  To enable, add this to your
  13. Xdefaults file:
  14.  
  15.     olvwm.iconToWindowLines:        False
  16.  
  17. t takes a little getting used to having windows just pop up without knowing
  18. here their icons were, but after a while you get really used to the speed
  19. ith which you can open and close windows.
  20.  
  21. ARDWARE NEEDED
  22. --------------
  23. his patch will only work if olvwm is going to run on a machine with a
  24. PARC processor which has the ability to play sounds.  Examples of such
  25. achines include Sun 4/25, Sun 4/60 and Sun 4/690.  There are many others,
  26. lso ones not made by Sun.
  27.  
  28. OFTWARE NEEDED
  29. --------------
  30. n order to compile this, you will need to get Mark Boyns' rplay library
  31. anonymous ftp @ sounds.sdsu.edu:/pub/rplay2.0.tar.Z)
  32. play is a neat facility which allows one to play multiple sounds
  33. n a machine.  The sounds names are sent using UDP packets and therefore
  34. o not use up much network bandwidth.
  35. e use rplay for all kinds of things in our office, although it was
  36. riginally developed to add sounds to games like xtank and xpilots.
  37. ven if you don't want to use it with your window manager, you should
  38. et it for other things.  We use it extensively for alarms and mail
  39. otification. You may wonder why we don't just use 'play'.  Well, we
  40. sed to, but rplay allows sounds to be played on remote machines AND
  41. t allows multiple sounds to be played.  In other words, it I am playing
  42.  long song and some important mail comes in, the mail sound will be mixed
  43. ith the currently playing song.
  44.  
  45. OW TO COMPILE AND INSTALL
  46. -------------------------
  47. ou need to first get a copy of the olvwm3.2 sources. (Check your nearest
  48. rchie database for locations of olvwm3.2.tar.Z or something similar)
  49. xtract the sources into a directory.
  50. o to this directory and type: patch -p0 <olvwm3.2-sounds.patch
  51. opefully this will all work.
  52. ow use your favorite way to compile olvwm.  (I use 'make -f Makefile.sunpro')
  53. f you are currently running olvwm, it would be wise to rename it to
  54. omething else: mv /usr/local/bin/olvwm /usr/local/bin/olvwm.old
  55. ollow the normal installation instructions for olvwm. (See the README file)
  56.  
  57. OW DOES IT WORK?
  58. ----------------
  59. nce you have a copy of the new olvwm, you can run it.
  60. here are a couple of things you need to do in order to make the sound
  61. dditions usefull.
  62. irst, you need to add a couple of items to your Utilities menu.
  63. ere is what I added:
  64.  
  65.     "Toggle Sound"                  FLIPSOUND
  66.     "Reread sounds"                 REREADSOUNDS
  67.  
  68. his will then allow you to 1) turn the sounds on and off, and 2) reread
  69. he event->sounds database.
  70.  
  71. ow you need to create a file called .olvwm-sounds in your home directory.
  72. his file contains the mappings from events to sounds.  The syntax is very
  73. imple:
  74.  
  75.     Event:    sound
  76.  
  77. or example, I have the following (I am a startrek fan...)
  78.  
  79.     KeyPress:       bloop2.au
  80.     MotionNotify:   Boiling.au
  81.     UnmapNotify:    mute2.au
  82.     MapNotify:      turbbeep.au
  83.     Startup:        welcome.au
  84.     Shutdown:       com-functions.au
  85.  
  86.  complete list of events can be found in Debug.c of the olvwm sources.
  87. he Startup and Shutdown events are not real olvwm events.  I have added
  88. hose so that you can play sounds at startup and shutdown of the window
  89. anager.
  90.  
  91. henever you make a change to the .olvwm-sounds file, you need to use the
  92. Reread sounds" menu item to let olvwm know about the changes.
  93.  
  94. ince editing this .olvwm-sounds file by hand can get really old really
  95. ast, I have also written a tool to do this for you.  It gives you two
  96. ists, one with all the events and the other with all the sounds which
  97. re registered with rplay.
  98.  will make this tool available for anonymous ftp @ sounds.sdsu.edu
  99. n /pub/olvwmtool.shar.  Note that I used Sun's DevGuide to write this
  100. pplication.  This is why I also have a (statically linked) sun4
  101. xecutable in /pub/olvwmtool.  The shar file contains all the files that
  102. evGuide generates, so you should be able to compile it without DevGuide.
  103.  
  104. ISCELANEOUS
  105. -----------
  106. eople may wonder what the overhead is to the window manager.  Well,
  107. ach sound that is played takes one (small) UDP packet.  The rplayd
  108. rogram receives this packet and plays the sound, but it does not take
  109. uch cpu time to do it.  (sounds are mostly interrupt driven)
  110.  have not noticed any slowdown with this addition to the window manager.
  111.  
  112. VAILABILITY
  113. -----------
  114. he latest version of all our sound programs will always be available for
  115. nonymous ftp on sounds.sdsu.edu in the /pub directory
  116. he archive also has about 350 MB of Sun U-LAW sound files.  Check it out.
  117. New uploads are always welcome, especially sound effects)
  118.  
  119. ROBLEMS
  120. -------
  121. f you have any problems or comments, please let me know.  I can be reached
  122. t andrew@sdsu.edu
  123.